home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmnscomp.z / pmnscomp
Text File  |  1997-04-03  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssccccoooommmmpppp - compile an ASCII performance metrics namespace into binary
  10.      format.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ppppmmmmnnnnssssccccoooommmmpppp [----dddd] [----ffff] [----nnnn _n_a_m_e_s_p_a_c_e] _o_u_t_f_i_l_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmnnnnssssccccoooommmmpppp compiles a Performance Metrics Name Space (PMNS) in ASCII format
  17.      into a more efficient binary representation.  ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is able
  18.      to load this binary representation significantly faster than the
  19.      equivalent ASCII representation.
  20.  
  21.      If _o_u_t_f_i_l_e already exists ppppmmmmnnnnssssccccoooommmmpppp will exit without overwriting it.
  22.  
  23.      By convention, the name of the compiled namespace is that of the root
  24.      file of the ASCII namespace, with ....bbbbiiiinnnn appended.  For example, the root
  25.      of the default PMNS is a file named rrrrooooooootttt and the compiled version of the
  26.      entire namespace is rrrrooooooootttt....bbbbiiiinnnn.
  27.  
  28.      The options are;
  29.  
  30.      ----dddd   By default the PMNS to be compiled is expected to contain at most
  31.           one name for each unique Performance Metric Id (PMID).  The ----dddd
  32.           option relaxes this restriction and allows the compilation of a PMNS
  33.           in which multiple names may be associated with a single PMID.
  34.           Duplicate names are useful when a particular metric may be logically
  35.           associated with more than one group of related metrics, or when it
  36.           is desired to create abbreviated aliases to name a set of frequently
  37.           used metrics.
  38.  
  39.      ----ffff   Force overwriting of an existing _o_u_t_f_i_l_e if it already exists.
  40.  
  41.      ----nnnn   Normally ppppmmmmnnnnssssccccoooommmmpppp operates on the default PMNS, however if the ----nnnn
  42.           option is specified an alternative namespace is loaded from the file
  43.           _n_a_m_e_s_p_a_c_e.
  44.  
  45.      The default input PMNS is found in the file /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t unless the
  46.      environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is
  47.      assumed to be the pathname to the file containing the default input PMNS.
  48.  
  49. FFFFIIIILLLLEEEESSSS
  50.      /_v_a_r/_p_c_p/_p_m_n_s/*         default PMNS specification files
  51.      /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t._b_i_n  compiled version of the default PMNS, when then
  52.                              environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is unset
  53.      /_v_a_r/_p_c_p/_p_m_n_s/_s_t_d_p_m_i_d   some standard macros for PMID generation
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      ppppmmmmnnnnssssaaaadddddddd(1), ppppmmmmnnnnssssddddeeeellll(1), ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3),
  57.      ppppmmmmTTTTrrrriiiimmmmNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) and ppppmmmmnnnnssss(4).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      Cannot open ``xyz'' - the filename for the root of the PMNS that was
  76.      passed to ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is bogus
  77.  
  78.      Illegal PMID - either one of the three PMID components (see ppppmmmmnnnnssss(4)) is
  79.      not an integer, or the value for one of the components is negative, or
  80.      too large.
  81.  
  82.      Expected ... - specific syntax errors when a particular type of lexical
  83.      symbol was expected and not found; the messages are intended to be self-
  84.      explanatory.
  85.  
  86.      Internal botch - implementation problem for the parser ...
  87.  
  88.      Duplicate name ``abc'' in subtree for ``pqr.xyz'' - for each non-leaf
  89.      node, the names of all immediate descendents must be unique.
  90.  
  91.      No name space entry for ``root'' - the special non-leaf node with a
  92.      pathname of ``root'' defines the root of the PMNS, and must appear
  93.      somewhere in the PMNS specification.
  94.  
  95.      Multiple name space entries for ``root'' - more than one ``root'' node
  96.      does not make sense!
  97.  
  98.      Disconnected subtree (``abc.xyz.def'') in name space - the pathname for
  99.      this non-leaf node does not correspond to any pathname in the PMNS, hence
  100.      this non-leaf node is ``orphaned'' in the PMNS.
  101.  
  102.      Cannot find definition for non-terminal node ``xyz'' in name space - a
  103.      non-terminal node is named as part of its parent's specification, but is
  104.      never defined.
  105.  
  106.      Duplicate metric id (xxx) in name space for metrics ``abc'' and ``xyz'' -
  107.      each PMID must be unique across the PMNS.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.